home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / os2 / pc2_140.zip / SOURCE.ZIP / Source / PC2.Ipp < prev    next >
Text File  |  1993-04-17  |  42KB  |  735 lines
  1. .imd PC2.h
  2. :userdoc.
  3. :title.PC/2 Help Program
  4. :body.
  5.  
  6.  
  7. .****************************************************************************************
  8. .*--------------------------------------------------------------------------------------*
  9. .* The user selected help with F1, the mouse or the keyboard.                           *
  10. .*--------------------------------------------------------------------------------------*
  11. .****************************************************************************************
  12.  
  13. :h1 res=&ID_HELP..PC/2 Help for Help
  14. :lines align=center.
  15. :color fc=red.
  16. PC/2 - Program Commander/2 Version 1.40
  17. for IBM OS/2 2.x Presentation Manager
  18. Copyright (C) by Stangl Roman 04, 1993
  19. :color fc=default.
  20. :elines.
  21. :p.Please select one of the following topics for further information:
  22. :ul compact.
  23. :li.:link reftype=hd res=&ID_ABOUTDIALOG..About the utility PC/2:elink.
  24. :li.:link reftype=hd res=&ID_INSTALLATIONHELP..Installing PC/2:elink.
  25. :li.:link reftype=hd res=&ID_GENERALHELP..Using PC/2 as a WPS addon:elink.
  26. :li.:link reftype=hd res=&ID_CONCEPTSHELP..Concepts of the Popup-Menu:elink.
  27. :li.:link reftype=hd res=&ID_USINGHELP..Starting a Program from PC/2:elink.
  28. :li.:link reftype=hd res=&ID_CONFIGDIALOG..Setup the Popup-Menu:elink.
  29. :ul compact.
  30. :li.:link reftype=hd res=&MIID_MENUDIALOG..Adding a Submenu:elink.
  31. :li.:link reftype=hd res=&PIID_PROGRAMDIALOG..Adding a Program:elink.
  32. :li.:link reftype=hd res=&RDID_RESORTDIALOG..Resorting a (Sub)menu:elink.
  33. :li.:link reftype=hd res=&SUID_STARTUPDIALOG..Run-time parameters:elink.
  34. :eul.
  35. :li.:link reftype=hd res=&ID_ERRORHELP..Error messages:elink.
  36. :eul.
  37. :p.:link reftype=hd res=&ID_HELP..<Backward>:elink.
  38.                                   :link reftype=hd res=&ID_ABOUTDIALOG..<Forward>:elink.
  39.  
  40.  
  41. .****************************************************************************************
  42. .*--------------------------------------------------------------------------------------*
  43. .* The user selected help from the About PC/2 dialog box.                               *
  44. .*--------------------------------------------------------------------------------------*
  45. .****************************************************************************************
  46.  
  47. :h1 res=&ID_ABOUTDIALOG..Help for About PC/2
  48. :lines align=center.
  49. :color fc=red.
  50. PC/2 - Program Commander/2 Version 1.40
  51. for IBM OS/2 2.x Presentation Manager
  52. Copyright (C) by Stangl Roman 04, 1993
  53.  
  54. University for Business Administration
  55. and Management Vienna, Austria
  56. (Wirtschaftsuniversität Wien)
  57. :color fc=default.
  58. :elines.
  59. :p.E-Mail:
  60. :ul compact.
  61. :li.8650533@awiwuw11.wu-wien.ac.at
  62. :li.Roman Stangl @ IBM Austria National Support BBS ((0043) 0222 21145 6600)
  63. :eul.
  64. :p.This program is classified as Freeware. Under the copyright, you are allowed and
  65. encouraged to freely use, distribute or modify this program under the following
  66. conditions:
  67. :ul compact.
  68. :li.The complete source code and all executables are included. This rule also applies
  69. for any modifications you made.
  70. :li.You may only charge for the costs of duplicating.
  71. :li.:hp7.Any:ehp7. commercial use is prohibited without contacting me prior, except
  72. for incorporating the idea/code in any future release of OS/2 by IBM, however this
  73. clause doesn't apply for any private use.
  74. :li.You don't want to port this utility to MS Windows or Windows NT (never there).
  75. :eul.
  76. :p.You are encouraged to upload this utility to your favourite file-server or
  77. BBS. Please ensure that no file is missing, if you change the archive to
  78. a different compression scheme.
  79. :p.If you find this program useful and want to honor the six weeks of work writing
  80. this utility, you are welcome to send me a small fee of about 50 to 150 Austrian
  81. Schilling (about 5 to 15 dollar) to my home address. Of course you don't need
  82. to pay again, if a new release of PC/2 comes out.
  83. Please send any donations in cash, because it makes some troubles to exchange
  84. money orders or similar in Austria!
  85. Any suggestions are of course welcome too.
  86. :p.Thanks to all those, who sent me proposals and bug reports to improve this
  87. utility!
  88. :p.My home address is:
  89. :sl compact.
  90. :li.    Roman Stangl
  91. :li.    Strebersdorferstrasse 46
  92. :li.    2103  Langenzersdorf, Austria
  93. :esl.
  94. :p.:link reftype=hd res=&ID_HELP..<Backward>:elink.
  95.                                   :link reftype=hd res=&ID_INSTALLATIONHELP..<Forward>:elink.
  96.  
  97.  
  98. .****************************************************************************************
  99. .*--------------------------------------------------------------------------------------*
  100. .* The user selected help for PC/2 installation.                                        *
  101. .*--------------------------------------------------------------------------------------*
  102. .****************************************************************************************
  103.  
  104. :h1 res=&ID_INSTALLATIONHELP..Installing PC/2
  105. :p.You have obviously started PC/2 once, because you are reading this help panel.
  106. The installation is just straight forward with the REXX script that installs PC/2,
  107. however there are some points to notice:
  108. :ul.
  109. :li.The installation installed an icon on the Desktop and started the help panels
  110. of PC/2. To ensure that OS/2 starts PC/2 automatically the next time you boot your
  111. system, you must start PC/2 again (you then can notice that the background behind
  112. the icon changes). If you have added :hp3.SET RESTARTOBJECTS=STARTUPFOLDERSONLY:ehp3.
  113. in your :hp2.CONFIG.SYS:ehp2. then you must also add a shadow of PC/2 to your startup
  114. folder to ensure PC/2 is started the next time you boot OS/2.
  115. :li.PC/2 requires the file :hp2.PC2HOOK.DLL:ehp2. to be accessible. PC/2 tries
  116. to find this file either in the directory, where PC/2 was started from, or in a path
  117. that is included in the environment variable :hp3.LIBPATH:ehp3.. PC/2 will
  118. issue an error message, if it can't find it.
  119. The file :hp2.PC2.HLP:ehp2. may be either accessible in the directory,
  120. where PC/2 is started from, or in a path that is included in the environment
  121. variable :hp3.HELP:ehp3.. If you have problems running PC/2, ensure,
  122. that the working directory of PC/2 is accessible by these variables
  123. in your :hp2.CONFIG.SYS:ehp2..
  124. :li.The installation assumes that you are using the default profile :hp2.Pc2.cfg:ehp2.
  125. containing a standart pre-defined Popup-Menu. If you want to use an other Popup-Menu,
  126. you have to open the Settings of PC/2 and add your preferred profile in the
  127. :hp3.Parameters:ehp3. entryfield. Please click for the next help panel to see the
  128. syntax of the command-line parameters of PC/2. This command-line parameters then
  129. must be added to the :hp3.Parameters:ehp3. entryfield.
  130. :li.You can only run one copy of PC/2 concurrently.
  131. :li.If you select a DOS-Program to be started via PC/2, the time-slice of their
  132. sessions is optimized (the DOS-Settings are modified to
  133. :hp3.IDLE_SECONDS=5 IDLE_SENSITIVITY=100:ehp3.) to get a better performance. This
  134. is useful for most DOS games.
  135. :li.You may use PC/2 with or without the WPS installed, you may even use PC/2 as
  136. a replacement for the WPS. To do so you must install PC/2 first. Then you have
  137. to ensure that :hp2.PC2HOOK.DLL:ehp2. is accessible by PC/2. PC/2 tries to find
  138. this file in the directory where PC/2 is started from or in a path pointed to by
  139. the :hp3.LIBPATH:ehp3. environment variable in your :hp2.CONFIG.SYS:ehp2..
  140. You also have to ensure that :hp2.PC2.HLP:ehp2. is accessible in the PC/2 directory or
  141. in a path pointed to by the :hp3.HELP:ehp3. environment
  142. variable in your :hp2.CONFIG.SYS:ehp2. file. The default access ":hp2..;:ehp2." is
  143. :hp7.not:ehp7. sufficient. Then replace the statement 
  144. :hp2.SET RUNWORKPLACE=C&colon.\OS2\PMSHELL.EXE:ehp2. with
  145. :hp2.SET RUNWORKPLACE=[path]PC2.EXE:ehp2. where :hp2.[path]:ehp2. is the pathname
  146. of the directory you installed PC/2. The next time you boot, PC/2 will be
  147. started as a replacement for the WPS.
  148. Be carefull, OS/2 seems to dislike any parameters added to the program that
  149. is started as the WPS!
  150. :p.:hp7.Caution! PC/2 was not tested on all OS/2 versions or installed software
  151. and hardware :ehp7.(simply because I don't have them):hp7., so there may be
  152. bugs!:ehp7.. Of course you can start the WPS from a command prompt by typing
  153. :hp2.START PMSHELL:ehp2. or add a corresponding entry to PC/2.
  154. :eul.
  155. :p.:link reftype=hd res=&ID_ABOUTDIALOG..<Backward>:elink.
  156.                                   :link reftype=hd res=&ID_GENERALHELP..<Forward>:elink.
  157.  
  158.  
  159. .****************************************************************************************
  160. .*--------------------------------------------------------------------------------------*
  161. .* The user selected general help from the PC/2 main help panel.                        *
  162. .*--------------------------------------------------------------------------------------*
  163. .****************************************************************************************
  164.  
  165. :h1 res=&ID_GENERALHELP..General Help for PC/2
  166. :p.PC/2 - Program Commander is an addon for the WPS (Workplace Shell). The user
  167. can configure a menu that pops up, when the left mouse button is clicked anywhere
  168. on the Desktop. F.e. the Popup-Menu might look like:
  169. :artwork name='Pc2ipc01.bmp' align=left.
  170. :p.You have selected the item :hp3.Prompts:ehp3., which is a Submenu containing
  171. four more items. F.e. the item :hp3.OS/2 Window:ehp3. starts a windowed OS/2
  172. command prompt, when selected. This Popup-Menu is fully configurable, you may add,
  173. change or remove items. An item can either be a Submenu containing more items, or
  174. the name of a program.
  175. :p.Only the first Submenu :hp3.PC/2 Setup:ehp3. cannot be modified. This Submenu
  176. is used to setup PC/2 and to get help.
  177. :p.Your configuration is read from the default profile :hp2.Pc2.cfg:ehp2. each time
  178. PC/2 is started and saved every time you made changes.
  179. You can of course overwrite the default
  180. configuration filename to a file named :hp2.Filename.ext:ehp2. by invoking PC/2 with
  181. the following commandline option:
  182. :p.:hp2.PC2 [-Profile Filename.ext]:ehp2. or
  183. :p.:hp2.PC2 [/Profile Filename.ext]:ehp2.
  184. :p.where :hp2.Filename.ext:ehp2. conforms to a filename of a PC/2 profile. Both FAT
  185. and HPFS filename naming convention is accepted. A few
  186. sample configuration files are provided in this package.
  187. :p.As the default, the Popup-Menu appears if you double-click once on the Desktop,
  188. if no option or the following option is specified:
  189. :p.:hp2.PC2 [-DoubleClick]:ehp2. or
  190. :p.:hp2.PC2 [/DoubleClick]:ehp2.
  191. :p.You may select a single-click instead, by invoking PC/2 with the following
  192. commandline option:
  193. :p.:hp2.PC2 [-SingleClick]:ehp2. or
  194. :p.:hp2.PC2 [/SingleClick]:ehp2.
  195. :p.Please be sure not to combine both click behavior options.
  196. Of course the options changing the click behavior and the configuration
  197. filename options may be combined.
  198. :p.Because some people use PC/2 as a WPS replacement, PC/2 contains a Menuitem
  199. to ShutDown OS/2. By selecting this entry, it is safe to power off your PS/2 or
  200. PC after all disk activity has been stopped, although no windows are closed.
  201. If you run PC/2 as a WPS replacement and may want to start the WPS either by
  202. starting :hp2.PMSHELL.EXE:ehp2. from a command prompt or by starting a
  203. :hp2.PMSHELL:ehp2. Menuitem with PC/2.
  204. You then can follow the WPS initialization by heavy disk access and
  205. buildup of your Desktop with objects.
  206. PC/2 requires to know the Desktop (in technical terms the window handle
  207. of the Desktop) to be able to catch mouse button 1 clicks. If you start
  208. the WPS the Desktop changes too. Therefor PC/2 checks regularily (about every
  209. 2.5 seconds) if the Desktop has changed, so you may have to wait a little bit,
  210. after the WPS was started, that PC/2 recognizes mouse clicks again..
  211. :p.I would strongly recommend to start PC/2 during OS/2 boot. If you don't
  212. want to use the default profile, don't forget to add :hp2./Profile Filename.exe:ehp2.
  213. to the :hp3.Parameters:ehp3. entryfield in the Settings of PC/2.
  214. :p.The reason why I wrote this utility was primarily, that many programs
  215. installed on a system require many folders and icons on the Desktop. But to
  216. start a program, I don't want to open and close folders, so I made shadows on
  217. the Desktop messing it up. The solution I prefer is to click on the Desktop,
  218. getting immediately a menu and selecting the application from this menu. So
  219. PC/2 may help you to start your programs quickly, without needing to open
  220. and close folders.
  221. :p.:link reftype=hd res=&ID_INSTALLATIONHELP..<Backward>:elink.
  222.                                   :link reftype=hd res=&ID_CONCEPTSHELP..<Forward>:elink.
  223.  
  224.  
  225. .****************************************************************************************
  226. .*--------------------------------------------------------------------------------------*
  227. .* The user selected concepts from the PC/2 main help panel.                            *
  228. .*--------------------------------------------------------------------------------------*
  229. .****************************************************************************************
  230.  
  231. :h1 res=&ID_CONCEPTSHELP..Concepts of PC/2
  232. :p.The basic idea behind PC/2 is to have an configurable Popup-Menu available,
  233. to start programs quicky, without having to open and close folders.
  234. :p.The Popup-Menu, popped up when you click the left mouse button anywhere on
  235. the Desktop (just like the right one for shutdown), consists of so-called
  236. items. An item may be a Submenu, which contains further items, or the title of
  237. an Application. A Submenu contains a little arrow right beside the title of
  238. the Submenu.
  239. :p.You can imagine this Popup-Menu as a tree, with applications as leaves and
  240. Submenus as nodes. PC/2 allows you to freely build your own tree. To do so
  241. you have to click on the Desktop with the left mouse button and to select
  242. :hp2.PC/2 Setup &rarrow. Configure PC/2:ehp2.. A dialog box appears, where you
  243. can add, modify or remove Submenus and Applications. The listbox displays all
  244. Submenus and Applications of one level (like a cut through the tree). Of
  245. course you may change this level up and down.
  246. :p.Once you have configured your tree of Submenus and Applications, just press
  247. :hp2.Ok:ehp2. to take them into effect and save them to the profile or
  248. :hp2.Cancel:ehp2. to take them into effect without saving.
  249. :p.:link reftype=hd res=&ID_GENERALHELP..<Backward>:elink.
  250.                                   :link reftype=hd res=&ID_USINGHELP..<Forward>:elink.
  251.  
  252.  
  253. .****************************************************************************************
  254. .*--------------------------------------------------------------------------------------*
  255. .* The user selected help for starting a program from PC/2.                             *
  256. .*--------------------------------------------------------------------------------------*
  257. .****************************************************************************************
  258.  
  259. :h1 res=&ID_USINGHELP..Help for starting a program via PC/2
  260. :p.After you have configured the PC/2 Popup-Menu, you click on the Desktop
  261. with the left mouse button, select the Application you want to start and click on it.
  262. The Application will be started as if you were clicking on an icon.
  263. :p.One advantage starting an Application this way is, that you can manipulate
  264. many parameters on how the Application is started, one thing you can't do with
  265. many icons. F.e. you can start it invisible (useful for a backup program), making
  266. it only visible by selecting it from the tasklist. You may also specify the size
  267. of the Application or to start it in the background.
  268. :p.You can also start WPS objects, f.e. the Drives object or the Selective
  269. Install.
  270. If you have an WPS object, that represents a seamless WIN-OS2 application,
  271. you may even launch such a session.
  272. Be warned! - you have to create an WPS Object with :hp2.MAKEOBJ.CMD:ehp2. first
  273. to define an Object ID (Identifier) with that Object, to enable PC/2 to get
  274. this ID.
  275. :p.To close an Application, select the corresponding option from the Application
  276. or terminate it from the tasklist.
  277. :p.:link reftype=hd res=&ID_CONCEPTSHELP..<Backward>:elink.
  278.                                   :link reftype=hd res=&ID_CONFIGDIALOG..<Forward>:elink.
  279.  
  280.  
  281. .****************************************************************************************
  282. .*--------------------------------------------------------------------------------------*
  283. .* The user selected help from the Configuration/Setup PC/2 dialog box.                 *
  284. .*--------------------------------------------------------------------------------------*
  285. .****************************************************************************************
  286.  
  287. :h1 res=&ID_CONFIGDIALOG..Help for PC/2 Configuration
  288. :p.In the listbox, all Submenus and Applications of one level (imagine as a cut
  289. through the tree) are displayed. A Submenu has an arrow right beside it. F.e. assume
  290. the listbox contains 3 Submenus and 2 Appliations resulting in the following Popup-Menu:
  291. :artwork name='Pc2ipc02.bmp' align=left.
  292. :p.You may want to get into the Submenu :hp3.Prompts:ehp3.. Just select the Submenu
  293. :hp3.Prompts:ehp3. an click on the button :hp2.Level Down >>:ehp2.. The listbox
  294. will now be filled with all Submenus and Applications of the Submenu :hp3.Prompts:ehp3..
  295. To get one level up, simply press :hp2.<< Level Up:ehp2.. If nothing seems to
  296. change, you may be either at the highest level (the root of the tree) or at 
  297. the deapest level (a leaf of the tree) of a Submenu.
  298. :p.To configure the Popup-Menu just select an item.
  299. :ul compact.
  300. :li.To change or to remove this item use the buttons :hp2.Change Entry:ehp2. 
  301. or :hp2.Remove Entry:ehp2.. Either a new dialog appears allowing you to change
  302. the item, or the item will be removed.
  303. :li.To add a Submenu or an Application press the buttons :hp2.Add Submenu:ehp2.
  304. or :hp2.Add Program:ehp2.. A new dialog is displayed allowing you to add a new
  305. Submenu or Application, after pressing :hp2.Ok:ehp2. in this dialog, the Submenu
  306. or Application will be inserted :hp7.after:ehp7. the selected item, or at
  307. the end of the list if no item is selected.
  308. :li.To resort a Submenu press the button :hp2.Resort Menu:ehp2..
  309. A new dialog is displayed allowing you to resort the currently listed Submenu.
  310. Press here to get more information about the
  311. :link reftype=hd res=&RDID_RESORTDIALOG..Resort:elink. dialog.
  312. :eul.
  313. :p.If the listbox is empty, you can't remove or change anything. You also can't
  314. select any item, but in this case you can add a Submenu or an Application by
  315. just pressing the buttons, without needing to select an item.
  316. :p.Press :hp2.Ok:ehp2. to write the configuration to the profile, or press
  317. :hp2.Cancel:ehp2. to keep the changes only in memory. Both buttons will dismiss
  318. the dialog.
  319. :p.:link reftype=hd res=&CDID_HELP_1..Example 1:elink.
  320.      :link reftype=hd res=&CDID_HELP_2..Example 2:elink.
  321. :p.:link reftype=hd res=&ID_CONCEPTSHELP..<Backward>:elink.
  322.                                   :link reftype=hd res=&MIID_MENUDIALOG..<Forward>:elink.
  323.  
  324. .*--------------------------------------------------------------------------------------*
  325. .* The user selected example 1 from the Setup PC/2 help.                                *
  326. .*--------------------------------------------------------------------------------------*
  327.  
  328. :h2 res=&CDID_HELP_1..Setup example 1
  329. :p.Assume the listbox contains the following items resulting in the following Popup-Menu:
  330. :artwork name='Pc2ipc03.bmp' align=left.
  331. :p.You want to remove the Submenu :hp3.Editors:ehp3., rename the Submenu
  332. :hp3.Tools:ehp3. to :hp3.Utilities:ehp3. and add a Submenu :hp3.Demos:ehp3..
  333. :ol compact.
  334. :li.Select the item :hp3.Editors:ehp3.. You can now press the button
  335. :hp2.Remove Entry:ehp2. to remove the submenu, but only if this Submenu is empty.
  336. If it isn't empty, get into this Submenu by pression :hp2.Level Down >>:ehp2.
  337. and remove all items.
  338. :li.To rename :hp3.Tools:ehp3. to :hp3.Utilities:ehp3. select the item
  339. :hp3.Tools:ehp3. and press the button :hp2.Change Entry:ehp2.. A dialog box
  340. appears allowing you to rename this item.
  341. :li.Select the item, after which you want to insert the new Submenu. Then press
  342. the button :hp3.Add Submenu:ehp3. to add one. A dialog box appears allowing you
  343. to enter the title of a new Submenu.
  344. :eol.
  345.  
  346. .*--------------------------------------------------------------------------------------*
  347. .* The user selected example 2 from the Setup PC/2 help.                                *
  348. .*--------------------------------------------------------------------------------------*
  349.  
  350. :h2 res=&CDID_HELP_2..Setup example 2
  351. :p.Assume that you have remove all items, leading to an empty listbox. Now
  352. you want to add the Applications :hp3.Backup:ehp3. and :hp3.Terminal:ehp3..
  353. :ol compact.
  354. :li.The listbox is empty, so you can't select any item. Just press the
  355. button :hp2.Add Program:ehp2. and a dialog box appears, allowing you to
  356. enter all the data required for the new Application.
  357. :li.Now the listbox contains the item :hp3.Backup:ehp3., select it and
  358. press the button :hp2.Add Program:ehp2. a second time. Again you get
  359. a dialog box, where you enter the data for the Application :hp3.Terminal:ehp3..
  360. :eol.
  361.  
  362.  
  363. .****************************************************************************************
  364. .*--------------------------------------------------------------------------------------*
  365. .* The user selected help from the Menu installation PC/2 dialog box.                   *
  366. .*--------------------------------------------------------------------------------------*
  367. .****************************************************************************************
  368.  
  369. :h1 res=&MIID_MENUDIALOG..Help for PC/2 Menu Installation
  370. :p.This dialog is used to get a name for a Submenu, which is then added to the
  371. Popup-Menu. You can enter whatever you like, f.e. to make a Submenu that contains
  372. OS/2 utilities you might enter :hp3.Utilities:ehp3..
  373. :p.If you have choosen in the previous dialog to change the name of a Submenu, then
  374. overwrite the pre-entered text.
  375. :p.Press :hp2.Ok:ehp2. to accept, or press :hp2.Cancel:ehp2. to ignore the data
  376. you entered.
  377. :p.:link reftype=hd res=&MIID_HELP_1..Examples:elink.
  378. :p.:link reftype=hd res=&ID_CONFIGDIALOG..<Backward>:elink.
  379.                                   :link reftype=hd res=&PIID_PROGRAMDIALOG..<Forward>:elink.
  380.  
  381. .*--------------------------------------------------------------------------------------*
  382. .* The user selected examples from the Menu installation PC/2 help.                     *
  383. .*--------------------------------------------------------------------------------------*
  384.  
  385. :h2 res=&MIID_HELP_1..Menu installation examples
  386. :p.Assume you have entered the following Submenu Titles:
  387. :dl tsize=22.
  388. :dthd.:hp2.Title
  389. :ddhd.Purpose:ehp2.
  390. :dt.Prompts
  391. :dd.You want to add a Submenu named :hp3.Prompts:ehp3., that contains OS/2 and DOS,
  392. fullscreen and windowed command prompts.
  393. :dt.Spreadsheets
  394. :dd.You want to add a Submenu named :hp3.Spreadsheets:ehp3. for your spreadsheet
  395. program like Lotus 123/G or Excel.
  396. :edl.
  397.  
  398.  
  399. .****************************************************************************************
  400. .*--------------------------------------------------------------------------------------*
  401. .* The user selected help from the Program installation PC/2 dialog box.                *
  402. .*--------------------------------------------------------------------------------------*
  403. .****************************************************************************************
  404.  
  405. :h1 res=&PIID_PROGRAMDIALOG..Help for PC/2 Program Installation
  406. :p.This dialog is used to get the title, the path and filename, the working
  407. directory and parameters of a Menuitem, which is then added to the Popup-Menu.
  408. Additionally you can fine-tune the appearance of the program you want to add
  409. to the Popup-Menu. However the standard selections should provide a basis
  410. that is sufficient for most applications.
  411. :p.Sometimes you want that you can enter a commandline parameter before
  412. an application is started, f.e. assume that you want to be prompted for
  413. a text file just before your text-editor is invoked. PC/2 allows you to
  414. be prompted for commandline parameters in addition to static parameters
  415. before the application is launched. Press on
  416. :link reftype=hd res=&SUID_STARTUPDIALOG..Commandline Parameters:elink.
  417. to find out more about this feature.
  418. :p.The standard file dialog is opened, if you pressed :hp2.File Find:ehp2..
  419. Then you can easily find the program you want to add, the data of this
  420. program are inserted automatically. If a batch file was selected, the batch
  421. file will be inserted as a commandline parameter of a command processor.
  422. :p.Alternatively PC/2 supports also Drag &. Drop.
  423. You can f.e. use a Drives Object to select one application to add to PC/2.
  424. Then drag it into a free area within the dialog and drop it.
  425. PC/2 will insert the entryfields and application type correspondingly.
  426. :p.You may also add WPS Objects, either manually or by Drag &. Drop.
  427. If you insert an WPS Object correctly (I know this is a little bit
  428. particular) you may start your objects via the PC/2 Popup Menu.
  429. To add WPS Objects you must know the Object ID (Identifier), either
  430. for the preinstalled Objects from :hp2.OS2_20.RC:ehp2. or the
  431. Object ID defined with installation of one WPS Object by :hp2.MAKEOBJ.CMD:ehp2..
  432. :p.If you have choosen in the previous dialog to change the data of a Program,
  433. then overwrite or change the options you want.
  434. :p.Press :hp2.Ok:ehp2. to accept, or press :hp2.Cancel:ehp2. to ignore the data
  435. you entered.
  436. :p.For more information click on one of the following items:
  437. :ul compact.
  438. :li.:link reftype=hd res=&PIID_HELP_2..Program Data:elink.
  439. :li.:link reftype=hd res=&PIID_HELP_3..Program Type:elink.
  440. :li.:link reftype=hd res=&PIID_HELP_4..Program Style:elink.
  441. :li.:link reftype=hd res=&PIID_HELP_5..Program Size &. Position:elink.
  442. :li.:link reftype=hd res=&PIID_HELP_6..Program Priority:elink.
  443. :eul.
  444. :p.:link reftype=hd res=&PIID_HELP_1..Examples:elink.
  445. :p.:link reftype=hd res=&MIID_MENUDIALOG..<Backward>:elink.
  446.                                   :link reftype=hd res=&RDID_RESORTDIALOG..<Forward>:elink.
  447.  
  448.  
  449. .*--------------------------------------------------------------------------------------*
  450. .* The user selected help from the Startup Parameters dialog box.                       *
  451. .*--------------------------------------------------------------------------------------*
  452.  
  453. :h1 res=&SUID_STARTUPDIALOG..Help for PC/2 Startup Parameters
  454. :p.PC/2 allows you to replace the commandline parameters of your application
  455. completly or partly.
  456. :p.F.e. assume you have a TCP/IP communications package installed on your
  457. system. You also have added an Menuitem that start a file transfer program named
  458. :hp3.FTP:ehp3.. :hp3.FTP:ehp3. requires as a parameter the name of the host
  459. you want to connect to.
  460. To prompt you for this parameter immediately before :hp3.FTP:ehp3. is started,
  461. you would modify the parameters entryfield of the PC/2 Program Installation
  462. dialog like :hp2.[Please enter host address]:ehp2.
  463. :p.Further assume that you selected the Menuitem :hp3.FTP:ehp3. from the
  464. Popup-Menu. Just before :hp3.FTP:ehp3. is started, a dialog box is displayed,
  465. requesting the host address from you. F.e. you will type
  466. :hp2.ftp-os2.nmsu.edu:ehp2., then the file transfer program will be invoked
  467. as if you typed :hp2.FTP ftp-os2.nmsu.edu:ehp2. from a commandline.
  468. :p.Generally the syntax for the commandline parameters is:
  469. :p.:hp2.Parameter(s) 1 [Text] Parameter(s) 2:ehp2.
  470. :p.Assume you typed :hp2.FirstFile.doc:ehp2. as the first and
  471. :hp2.ThirdFile.doc:ehp2. as the second parameter.
  472. You will be asked by a dialog box, what to replace :hp2.[Text]:ehp2. with.
  473. Assume you entered :hp2.MyFile.doc:ehp2. then the program will be invoked
  474. with the commandline parameters :hp2.FirstFile.doc MyFile.doc ThirdFile.doc:ehp2..
  475. The string :hp2.[Text]:ehp2. would have been replaced by :hp2.MyFile.doc:ehp2..
  476. Of course both parameters may be omited, both may contain more than one parameter
  477. or only one of them may present. Omiting :hp2.[Text]:ehp2. would start the
  478. application without asking you for a commandline parameter prior.
  479. :p.PC/2 allows you to edit commandline parameters similar to the WPS (open
  480. the Settings notebook of any application,
  481. position the cursor into the Parameters entryfield and
  482. press F1 or Help to get further information).
  483. :p.Press :hp2.Ok:ehp2. to accept the parameters you entered, or press
  484. :hp2.Cancel:ehp2. to replace the commandline parameters by an empty string.
  485.  
  486. .*--------------------------------------------------------------------------------------*
  487. .* The user selected examples from the Program installation PC/2 help.                  *
  488. .*--------------------------------------------------------------------------------------*
  489.  
  490. :h2 res=&PIID_HELP_1..Program installation examples
  491. :p.Assume you want to add Lotus 123/G:
  492. :dl tsize=22.
  493. :dthd.:hp2.Fieldname
  494. :ddhd.You would enter:ehp2.
  495. :dt.Program Title:
  496. :dd.:hp3.Lotus 123/G:ehp3.
  497. :dt.Path and Filename:
  498. :dd.:hp3.c&colon.\123g\123g.exe:ehp3.
  499. :dt.Working Directory:
  500. :dd.:hp3.c&colon.\123g:ehp3.
  501. :dt.Parameters:
  502. :dd.(none)
  503. :edl.
  504. :p.Lotus 123/G is a Presentation Manager application so you would select
  505. :hp3.Presentation Manager:ehp3. as program type. The program style may be
  506. :hp3.Maximized:ehp3., because more information is visible. The priority
  507. may be left at the default selection :hp3.No Change:ehp3..
  508. :p.Assume you want to add the WPS Object System Clock (located in the
  509. folder :hp2.OS/2 System &rarrow. System Setup:ehp2.):
  510. :dl tsize=22.
  511. :dthd.:hp2.Fieldname
  512. :ddhd.You would enter:ehp2.
  513. :dt.Program Title:
  514. :dd.:hp3.System Clock:ehp3.
  515. :dt.Path and Filename:
  516. :dd.:hp3.<WP_CLOCK>:ehp3.
  517. :dt.Working Directory:
  518. :dd.(n/a)
  519. :dt.Parameters:
  520. :dd.(n/a)
  521. :edl.
  522. :p.The System Clock is a WPS Object, so :hp3.WPS Object:ehp3. is
  523. selected as the program type.
  524. You may have to look into the file :hp2.OS2_20.RC:ehp2. to get the defined
  525. name of preinstalled WPS Objects.
  526. Most settings are not available for WPS Objects.
  527. :p.Assume you want to add the WPS Object seamless WIN-OS2 Clock.
  528. First you must create an WPS Object with a known Object ID (Identifier) with
  529. :hp2.MAKEOBJ.CMD:ehp2., a small REXX-utility supplied with PC/2.
  530. To do so, start :hp2.MAKEOBJ.CMD:ehp2. and supply the Object ID
  531. :hp3.<WP_WIN_CLOCK>:ehp3. when you're asked to.
  532. Then open the newly created Object Settings and change them as you
  533. usually do, when you want to make an Object for a seamless WIN-OS2
  534. session of the WIN-OS2 clock.
  535. After you have created the WIN-OS2 clock object, you can drag it into
  536. this dialog of PC/2:
  537. :dl tsize=22.
  538. :dthd.:hp2.Fieldname
  539. :ddhd.You would enter:ehp2.
  540. :dt.Program Title:
  541. :dd.:hp3.Clock:ehp3.
  542. :dt.Path and Filename:
  543. :dd.:hp3.<WP_WIN_CLOCK>:ehp3.
  544. :dt.Working Directory:
  545. :dd.(n/a)
  546. :dt.Parameters:
  547. :dd.(n/a)
  548. :edl.
  549. :p.The seamless WIN-OS2 Clock is a WPS Object, so :hp3.WPS Object:ehp3.
  550. is used as the program type.
  551. Assuming that you created the seamless WIN-OS2 clock object as outlined
  552. before, then the Object ID is :hp3.<WP_WIN_CLOCK>:ehp3..
  553. If you had an WPS Object before, and you don't know the Object ID, you
  554. have to create a new one with :hp2.MAKEOBJ.CMD:ehp2., to define a known
  555. Object ID.
  556. :p.Sorry, this may be a little complicated, but it is the only way I know
  557. to get a known Object ID and the only way I know to start seamless
  558. WIN-OS2 sessions.
  559.  
  560. :h2 res=&PIID_HELP_2..Program Data
  561. :p.For a normal user it is the easiest way to use the following guidelines.
  562. According to the type of application you add, some fields may not be editable
  563. or visible:
  564. :dl tsize=22.
  565. :dthd.:hp2.Fieldname
  566. :ddhd.You would enter:ehp2.
  567. :dt.Program Title:
  568. :dd.Here you enter the name, under which the program should appear in the tasklist.
  569. For OS/2 and DOS windows, this will be the title of the window.
  570. You may also name the Objects here, you want to add.
  571. :dt.Path and Filename:
  572. :dd.Here you enter the fully qualified path and filename. F.e. you might enter
  573. :hp3.c&colon.\os2\cmd.exe:ehp3. to obtain an OS/2 command prompt, or
  574. :hp3.c&colon.\os2\mdos\qbasic.exe:ehp3. to start the basic interpreter.
  575. :p.Here you also enter the name of WPS Objects.
  576. WPS Objects are referred either by their defined Object ID (Identity) f.e.
  577. :hp3.<WP_DRIVES>:ehp3. or :hp3.<WP_INST>:ehp3. for preinstalled Objects,
  578. of f.e. :hp3.<WP_USER_CALC>:ehp3. or :hp3.<WP_WIN_PBRUSH>:ehp3. for
  579. Objects installed by the user with :hp2.MAKEOBJ.CMD:ehp2., a REXX-utility
  580. supplied with PC/2.
  581. Preinstalled WPS Objects have usually a defined name, you may need to take a
  582. look into the file :hp2.OS2_20.RC:ehp2. to get further information.
  583. :p.PC/2 can only launch WPS Objects named by their defined ID, so be carefull
  584. to get either the correct ID from :hp2.OS2_20.RC:ehp2. or to define an Object
  585. with a known ID with :hp2.MAKEOBJ.CMD:ehp2.
  586. For a user installed Objects, you can freely use any name, preferably a
  587. descriptive name in the form :hp3.<WP_xxxx>:ehp3..
  588. :p.Sorry, this may be a little complicated, but it is the only way I know
  589. to get a known Object ID and the only way I know to start seamless
  590. WIN-OS2 sessions.
  591. You can't use the Program Template to create Objects if you want them to
  592. add to PC/2, because PC/2 can't obtain the Object ID of such Objects.
  593. :dt.Working Directory:
  594. :dd.Here you enter the directory where the EXE, HLP and DLL files of your
  595. application are located. Before the application is started, a change drive
  596. and change directory call is made, to make this directory the working directory.
  597. :dt.Parameters:
  598. :dd.Here you enter the parameters passed to the application. PC/2 allows you
  599. to be asked for commandline parameters before the application is invoked.
  600. Press on :link reftype=hd res=&SUID_STARTUPDIALOG..Commandline Parameters:elink.
  601. to find out more about this feature. Assume that you want
  602. to use VIEW.EXE to view the command reference, you would enter
  603. :hp3.c&colon.\os2\book\cmdref.inf:ehp3..
  604. :dt.DOS Settings:
  605. :dd.If you select as program type a DOS Full-Screen or DOS Window, a multiline
  606. entryfield is displayed where you can enter the DOS Settings you need. Default,
  607. the DOS Settings :hp3.IDLE_SECONDS=5:ehp3. and :hp3.IDLE_SENSITIVITY:ehp3. are
  608. added if you create a DOS application for the first time. (You have to spell
  609. the DOS Settings exactly as they are displayed in the standard DOS Settings
  610. dialog - even then some can't be set for whatever reasons there are.)
  611. :dt.:hp2.File Find:ehp2.&colon.
  612. :dd.If you click on this button, the standard file dialog of OS/2 is displayed
  613. where you can select the application you want to install. The application
  614. parameters (f.e. path) will then be inserted automatically in the
  615. corresponding entryfields.
  616. :dt.Drag &. Drop:
  617. :dd.You can alternatively use the Drag &. Drop operation to install one
  618. application. Select one application from f.e. a Drives object or from
  619. a filemanager, drag it into the dialog to any area that accepts it and
  620. drop it.
  621. The settings will be adjusted according to the application you dragged into.
  622. You may also drag any WPS Object into this dialog, but be carefull to
  623. verify the name of the Object, because I don't know how to do this
  624. automatically (you may need to look into :hp2.OS2_20.RC:ehp2.
  625. for the exact spelling of preinstalled Objects.
  626. :edl.
  627. :p.For a power user, the data entered may be less. Because the OS/2 API
  628. DosStartSession() is used to start the application, all rules for this
  629. API apply as described in the toolkit. Hence you may leave the entryfield
  630. Path and Filename blank and then select from the
  631. :link reftype=hd res=&PIID_HELP_3..Program Type:elink. group an
  632. OS/2 or DOS fullscreen or window, to get a command prompt.
  633. :p.You may also start an appliciation indirectly through a secondary command
  634. processor by specifying :hp3.c&colon.\os2\cmd.exe:ehp3. as the Path and Filename and
  635. use then the :hp3./C:ehp3. or :hp3./K:ehp3. option of CMD.EXE in the
  636. Parameters entryfield.
  637.  
  638. :h2 res=&PIID_HELP_3..Program Type
  639. :p.Here you can select the type of application you want to add.
  640. By default, PC/2 tries to determine the type of an application you installed
  641. via the standard file dialog or via Drag &. Drop.
  642. :p.You generally have to verify, that the Program Type setting corresponds
  643. to the application you installed, for most programs you can use
  644. :hp2.Determined by WPS:ehp2. if you aren't sure.
  645. :p.According to the Program Type that is selected, some settings may not
  646. be editable or visible.
  647. :p.OS/2 and DOS Fullscreen or Windows are only used, if you want to start
  648. a command prompt as the application. In this case, you usually enter in the
  649. the entryfield Path and Filename of the group Program Data the path of
  650. the corresponding command processor. A advanced technique to select the
  651. type of command processor only with these radiobuttons is described under
  652. the group :link reftype=hd res=&PIID_HELP_2..Program Data:elink..
  653.  
  654. :h2 res=&PIID_HELP_4..Program Style
  655. :p.These selections should be self-explanatory, you can only change one of
  656. the radiobuttons, but apply as many checkboxes as you want as the Program
  657. Style. F.e. if you selected :hp3.Minimized:ehp3., :hp3.Invisible:ehp3. and
  658. :hp3.Background:ehp3., the application will be started minimized, in the
  659. background and invisible (this may make sense for a backup program).
  660.  
  661. :h2 res=&PIID_HELP_5..Program Size &. Position
  662. :p.Here you can use the checkbox to start an application with a preselected
  663. size and position. If you select the checkbox :hp3.Size, Position:ehp3. you
  664. will be able to modify the size the started application should appear.
  665. :p.If you deselect the checkbox, the data will be saved, but the application
  666. is started ignoring the size and position you entered.
  667.  
  668. :h2 res=&PIID_HELP_6..Program Priority
  669. :p.At this level of development, I don't know how to change the priority of a
  670. program started as an independent session, so these radiobuttons are
  671. unavailable. I know how to change the priority started as a child of PC/2, but if the
  672. parent application PC/2 fails (by a bug or a close from the tasklist) all the
  673. childs are also terminated, which is surely unacceptable.
  674.  
  675.  
  676. .****************************************************************************************
  677. .*--------------------------------------------------------------------------------------*
  678. .* The user selected help from the Resort PC/2 dialog box.                              *
  679. .*--------------------------------------------------------------------------------------*
  680. .****************************************************************************************
  681.  
  682. :h1 res=&RDID_RESORTDIALOG..Help for PC/2 Resort
  683. :p.This dialog box contains two listboxes, the left one that displays the currently
  684. available Menuentries and the right one that displays the currently resorted
  685. Menuentries.
  686. Select the first Menuentry from the left listbox and press the 
  687. :hp2.Reorder:ehp2. button, to resort it to the right listbox.
  688. For the next Menuentry(ies) repeat this procedure, until the left listbox is empty.
  689. :p.You can cancel the resort before you have done any sort, but you have to resort
  690. the complete Submenu once you made one resort operation.
  691. :p.All sorted Menuentries in the right listbox can't be started with PC/2 until
  692. you complete the resort by pressing :hp2.OK:ehp2..
  693. Warning! - You have to press :hp2.OK:ehp2. in the :link reftype=hd 
  694. res=&ID_CONFIGDIALOG..Confguration Dialog:elink. to write the resorted Menuentries
  695. structure to the configuration file.
  696. :p.:link reftype=hd res=&PIID_PROGRAMDIALOG..<Backward>:elink.
  697.                                   :link reftype=hd res=&ID_ERRORHELP..<Forward>:elink.
  698.  
  699.  
  700. .****************************************************************************************
  701. .*--------------------------------------------------------------------------------------*
  702. .* The user selected error help.                                                        *
  703. .*--------------------------------------------------------------------------------------*
  704. .****************************************************************************************
  705.  
  706. :h1 res=&ID_ERRORHELP..Help for PC/2 Errors
  707. :p.PC/2 can't verify all user input for validity, so some user input may cause
  708. some PC/2 functions to fail. In this case, a message box is displayed containing
  709. the module and the sourcecode linenumber that failed. Also a error message is
  710. displayed containing which error occured and what should be done to resolve the
  711. problem.
  712. :p.F.e. you might have configured to start the program :hp3.VIEW.EXE:ehp3. by
  713. writing :hp3.c&colon.\os3\view.exe:ehp3. in the entryfield :hp2.Path and Filename:ehp2.
  714. in the Program Installation dialog. This of course leads to an error, because when
  715. OS/2 tries to start this item, it can't find the directory :hp3.\os3\:ehp3. simply
  716. because it should read :hp3.\os2\:ehp3.. A message box is displayed saying an
  717. error occured and that the user input should be corrected.
  718. :p.The messagebox has three buttons that may be pressed:
  719. :dl tsize=22.
  720. :dthd.:hp2.Button
  721. :ddhd.Result:ehp2.
  722. :dt.:hp2.Abort:ehp2.
  723. :dd.PC/2 will be terminated and all unsaved data will be lost. You have to restart
  724. PC\2 again. This button should be the last one you select.
  725. :dt.:hp2.Retry:ehp2.
  726. :dd.The error is ignored, you may need to correct your data entered in the entryfields.
  727. :dt.:hp2.Ignore:ehp2.
  728. :dd.The error is ignored, you may need to correct your data entered in the entryfields.
  729. :edl.
  730. :p.:link reftype=hd res=&RDID_RESORTDIALOG..<Backward>:elink.
  731.                                   :link reftype=hd res=&ID_HELP..<Forward>:elink.
  732.  
  733. :euserdoc.
  734.  
  735.